home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / utility / tsutlb21.zip / TSUTLB.INF < prev    next >
Text File  |  1995-12-02  |  12KB  |  320 lines
  1. Sat 2-December-1995
  2.  
  3. About TSUTLB in General                       (All rights reserved)
  4. =======================
  5.  
  6. This is the second package in my utilities series TSUTIL, TSUTLB,
  7. TSUTLC, TSUTLD, TSUTLE, and TSUTLF.
  8.  
  9. ┌───────────────────────────────────────────────────────────────┐
  10. │ Please do not distribute any part of this package separately. │
  11. └───────────────────────────────────────────────────────────────┘
  12.  
  13. This package may be used and distributed freely for NON-COMMERCIAL,
  14. NON-INSTITUTIONAL, PRIVATE purposes, provided it is not changed in
  15. any way. (Repacking with another method is ok, though.) For ANY
  16. other usage, such as use in a business enterprise or a university,
  17. contact the author for registration. Uploading to bulletin boards is
  18. encouraged.
  19.  
  20. The programs are under development. If you have any comments or bug
  21. reports, please do not hesitate to use electronic mail for
  22. communication.
  23.  
  24. The author shall not be liable to the user for any direct, indirect
  25. or consequential loss arising from the use of, or inability to use,
  26. any program or file howsoever caused. No warranty is given that the
  27. programs will work under all circumstances.
  28.  
  29. Timo Salmi (ts@uwasa.fi)
  30. Professor of Accounting and Business Finance
  31. Faculty of Accounting & Industrial Management
  32. University of Vaasa
  33. P.O. BOX 700, FIN-65101 Vaasa, Finland
  34.  
  35.  
  36. CONTENTS:
  37.  
  38.   1. Summary
  39.   2. Program Abstracts
  40.  
  41.  
  42. Timo Salmi UTiLities set B, release 2.1 (TSUTLB21) includes the
  43. *    *     ** *          *          * *
  44. following utility-type programs.
  45.  
  46. TSUTLB is a stand-alone sequel to TSUTIL. There is also a third
  47. collection of these utility programs called TSUTLC, a fourth called
  48. TSUTLD, a fifth called TSUTLE and a sixth called ... (you guessed it
  49. :-) ... TSUTLF.
  50.  
  51.  
  52. 1. SUMMARY
  53.  
  54. TSUTLB21        More command-like progs, T.Salmi
  55. Filename        Comment
  56. --------        --------------------------------
  57. CHARS.EXE       Character frequencies of a file
  58. DIRE.EXE        Extended directory
  59. FILE_ID.DIZ     Brief characterization of TSUTLB
  60. SETGRA.EXE      Sets computer into graphics mode
  61. TOUCH.EXE       Change date/time stamp of files
  62. TSPROG.INF      List of PD programs from T.Salmi
  63. TSUTLB.INF      Document
  64. TSUTLB.NWS      News announcements about tsutlb
  65. VAASA.INF       Info: Finland, Vaasa, U of Vaasa
  66. ----            ------             ------  -----
  67. 0009
  68.  
  69. TSUTLB releases until TSUTLB14 were distributed under the name of
  70. TS2UTL.
  71.  
  72.  
  73. 2. PROGRAM ABSTRACTS
  74.  
  75. CHARS (Ver. 1.3)  Character frequencies of a file
  76. ================
  77.  
  78. Usage : CHARS <source file> [statistics output file]
  79.    or   CHARS ?
  80.  
  81. This program makes a statistics of the occurrence of the different
  82. characters in any type of file. The frequencies of the characters
  83. are given both in the ascending order of character ascii numbers and
  84. in the descending order of the frequencies. This is a Turbo Pascal
  85. 7.0 program using BlockRead for fast file handling, and quicksort
  86. for fast sorting of the frequencies.
  87.  
  88. Release notes:
  89.  
  90.  Version 1.1 handles also ascii 255 correctly.
  91.  
  92.  Version 1.2 has some minor stylistic changes.
  93.  
  94.  Version 1.3 minor text changes.
  95.  
  96.  
  97. DIRE.EXE (Ver. 1.4)  Extended directory
  98. ===================
  99.  
  100. Usage: DIRE [DirectoryMask] [/a] [/c] [/m] [/p]
  101.         Allocated file sizes ─┘    │    │    │
  102.              Colors with ansi.sys ─┘    │    │
  103.                       Month as letters ─┘    │
  104.                                      Paging ─┘
  105.  
  106. or DIRE ?
  107.  
  108. DIRectory Extended command displays the directory in a format
  109. similar to MS-DOS dir command. However, DIRE also displays the
  110. hidden files as well as shows the status of the files (d=directory,
  111. h=hidden, r=read-only). (The status of the archive bit is not
  112. shown.)
  113.  
  114. Another difference compared to dir is that the file name and the
  115. extension are separated by a point, not a tab. Thus e.g. you would
  116. get DIRE.EXE rather than DIRE     EXE. This makes a difference e.g.
  117. when you direct the directories to a file, and wish to search for a
  118. specific file name. This has been changed, however, in version 1.1
  119. to correspond to the Ms-Dos format. The Ms-Dos tabs are replaced by
  120. the more universal blanks.
  121.  
  122. DIRE requires a stricter syntax of file names than dir. If you make
  123. a mistake, DIRE shows you examples of the correct syntax. The main
  124. rule is that you should either use no parameter, or enter the
  125. device, path, and file names, all explicitly. Examples of acceptable
  126. commands are:
  127.  
  128.  DIRE
  129.  DIRE *.*
  130.  DIRE A:
  131.  DIRE A:\*.PAS
  132.  DIRE A:\SUBDIR\*.EXE
  133.  DIRE ..
  134.  DIRE SUBDIR           (Shows entries named subdir in the CURRENT directory!)
  135.  DIRE SUBDIR\          (Shows entries in subdirectory subdir)
  136.  DIRE A:SUBDIR\
  137.  DIRE SUBDIR\*.EXE
  138.  DIRE ..\SUBDIR\*.*
  139.  
  140. Unlike dir DIRE can handle the wildcards * and ? also in directory
  141. names. Therefore DIRE SUBDIR and DIRE SUBDIR\ will (contrary to dir)
  142. show you different informations. The former will show if your
  143. default directory has a subdirectory named SUBDIR while the latter
  144. shows the contents of SUBDIR.
  145.  
  146. The optional parameter /p will cause a pause at each full screen.
  147. E.g.
  148.  DIRE *.PAS /p
  149.  DIRE /p
  150. The /p parameter must be preceded at least by one blank.
  151.  
  152. DIRE has been compiled with Borland's Turbo Pascal Version 5.0.
  153.  
  154. See DIRF in package TSUTLC for a directory program with more
  155. features. DIRF practically outdates DIRE.
  156.  
  157. Release notes:
  158.  
  159.  Version 1.1: The file name extensions have been aligned to start
  160. from the same column. The date-stamp of the files also shows the
  161. weekday.
  162.  
  163.  Version 1.2: Added the [/a(llocated size)] and [/m(onth as text)]
  164. switches. Added the code s for system files in the listing.
  165.  
  166.  Version 1.3: Rewrote, or rather took from my other directory
  167. programs the routines to handle the file masks. Thus the searchname
  168. convention for DIRE is much closer to MS-DOS DIR, as it should.
  169.  
  170.  Version 1.4: Added switch /c for displaying the directory list in
  171. color using ansi.sys or a similar screen driver. Note that if you do
  172. not have ansi.sys (or a compatible driver) installed, using the /c
  173. switch will produce somewhat confusing looking output with all the
  174. escape sequences displayed.
  175.  
  176.  
  177. SETGRA.EXE (Ver. 1.2)  Sets computer into graphics mode
  178. =====================
  179.  
  180. Usage: SETGRA <graphics driver selection>
  181.    or: SETGRA ?
  182.  
  183. Options:
  184. Def CGA MCGA EGA EGA64 EGAMono IBM8514 HercMono ATT400 VGA PC3270
  185.  
  186. This program sets your computer in a graphics mode. It can also be
  187. used to to restore the textmode by giving the program call without
  188. any parameters.
  189.                                                                               
  190. There are two common reasons for wanting to be able to invoke the
  191. graphics mode: 1) There are some programs which require that they
  192. are called in the graphics mode. 2) You may want to experiment with
  193. your graphics capabilities.
  194.  
  195. You can let SETGRA identify your graphics drivers by using Def as
  196. the parameter in the program call. Or you can experiment which
  197. graphics drivers your machine can handle by selecting the driver
  198. from the list. Notice, however, that selecting a graphics driver
  199. which your machine cannot handle may cause a system crash and you
  200. then have to reset your machine.
  201.  
  202. IBM8514.BGI belongs to Borland International and is attached to
  203. SETGRA.EXE in accordance with Borland's No-Nonsense License
  204. Statement. IBM8514.BGI is needed (in the program directory) if you
  205. want to invoke the IBM-8514 graphics.
  206.  
  207.   Release notes: Version 1.1: The IBM8514.BGI is no longer needed
  208. separately, and has thus been omitted. I have now linked (also) this
  209. driver into the program code. Since I have not had an access to PC
  210. with IBM8514 graphics mode, I cannot be absolutely certain that this
  211. option really works. (The others do, and I do not see why this
  212. wouldn't, so it probably won't.)
  213.  
  214.   Version 1.2: Still wondering about the IBM8514 graphics.
  215.  
  216.  
  217. TOUCH (Ver. 1.7)  Change date/time stamp of files
  218. ================
  219.  
  220. Usage: TOUCH filename [(new date dd-mm[-[yy]yy]) (new time hh:mm[:ss])]
  221.                       [/n(o confirm)] [/fFileName2 (stamp from)]
  222.    or: TOUCH ?
  223.  
  224. TOUCH changes the datestamp and timestamp of a files. Wildcards (*
  225. and ?) and paths are allowed. If you omit the date and the time, the
  226. current date and time are used. You can also apply 'today' in the
  227. date, and 'now' in the time. TOUCH asks for your confirmation before
  228. changing the stamps.
  229.  
  230. ┌────────────────────────────────────────────────────────────────────────┐
  231. │ WARNING: Don't change the date nor the time stamps of files unless you │
  232. │ have a good reason for it. If you do not know what these reasons are,  │
  233. │ then do not use this program!                                          │
  234. └────────────────────────────────────────────────────────────────────────┘
  235.  
  236. The accuracy of the time stamp is ±1 second (feature of Turbo Pascal
  237. time packing). Hence the last second may have a slight deviation.
  238.  
  239. Examples of usage:
  240.  
  241. TOUCH MYFILE.TXT
  242. TOUCH MYFILE.*
  243. TOUCH MYFILE.TXT 29-11-95 12:00
  244. TOUCH MYFILE.TXT 29-NOV-95 12:00
  245. TOUCH MYFILE.TXT TODAY 12:00
  246. TOUCH MYFILE.TXT /N OLDATE NOW
  247. TOUCH R:MYFILE.TXT /FMYFILE2.TXT
  248.  
  249. If the file does not exist, TOUCH asks if you wish to have the file
  250. created. This, of course, only applies to unique (i.e. non-wildcard)
  251. file names only. The no-confirm switch /n concerns touching the file
  252. date/time stamp. If does not affect confirming the creation of a new
  253. file. That confirmation will always be asked for.
  254.  
  255. Examples with non-existent file names:
  256.  
  257. TOUCH NEW.TXT /n
  258. File R:\NEW.TXT not found, create [n,y]? y
  259. R:\NEW.TXT
  260. 02-12-1995 05:33:14 ==> 02-12-1995 05:33:14
  261. R:\NEW.TXT touched
  262.  
  263. TOUCH NEW2.TXT
  264. File R:\NEW2.TXT not found, create [n,y]? y
  265. R:\NEW2.TXT
  266. 02-12-1995 06:14:24 ==> 02-12-1995 06:14:25 [y,n,q]? n
  267.  
  268. TOUCH NEW3.TXT /FR:\NEW.TXT
  269. File R:\NEW3.TXT not found, create [n,y]? y
  270. R:\NEW3.TXT
  271. 02-12-1995 06:20:46 ==> 02-12-1995 05:33:14 [y,n,q]? y
  272. R:\NEW3.TXT touched
  273.  
  274.  
  275. Release Notes:
  276.  
  277. Version 1.1: Some messages have been corrected.
  278.  
  279. Version 1.2: The new /n switch can be used to turn touch
  280. confirmation off. The year can now also be given as two digits only.
  281.  
  282. Version 1.3:
  283. - The confirmation [y,n,q] no longer requires pressing the enter
  284.   key.
  285. - Keywords 'oldate' and 'oldtime' are available for added
  286.   flexibility.
  287. - The date can be given without the year as day-month. The current
  288.   year is then the default.
  289. - Date can use . and / along with the former -
  290. - Time can use . along with the former :
  291.  
  292. Version 1.4:
  293. - Corrected a stupid blunder which took answering no as answering
  294.   yes.
  295.  
  296. Version 1.5:
  297. - Added the option (switch /fFileName2) to "copy" the date/time
  298.   stamp of another file to the target file.
  299. - Corrected the bug that prevented the program working properly when
  300.   the /n (no confirm) switch was set on.
  301. - Improved some of the error messages.
  302. - Ensured that reserved names (like PRN, NUL etc) cannot be touched.
  303. - Ensured that system files cannot be touched. Earlier only hidden
  304.   and read-only files were detected.
  305. - TOUCH now also displays the names read-only, hidden, and system
  306.   files if wildcards indicate any of them (but does not try to touch
  307.   them).
  308.  
  309. Version 1.6:
  310. - The month can now be given as a three letters. Thus examples of
  311.   acceptable dates include 21-3-92 21-Mar-92 21/03/1992 21.3.92
  312.   today oldate.
  313.  
  314. Version 1.7:
  315. - If the file to be touched does not exist, the user is asked if
  316.   s/he wants the file created. Logically, this does not cover file
  317.   names that include wildcards (* and ?).
  318. - Added examples of the usage both to the documentation and to the
  319.   program's help screen.
  320.